Checking For Updated Track Rights

Our music catalog contains music that is fully cleared for use in your app. However, rights for certain songs change from time to time, which might result in the loss of rights to use in your app. For example, the ownership of a particular song might be sold or set to expire on a specific date, in which case we'd lose the clearance that was previously in place.

We monitor the rights data for all songs in the Clips catalog on a daily basis. If rights for a particular song are no longer valid, we will reflect that through a few API endpoints, and it's imperative that your app uses at least one of them to clear clips prior to playback. The particular endpoint to use will depend on your specific implementation of our API.

Live-fetch Playback

If your app obtains a fresh clip URL from our API each time you want to play a clip, then you will be using the /music-fetch endpoint. This endpoint takes a list of clip IDs and returns a list of clips objects in the same order. Any clips that are NOT licensed for playback will be sent with success: false instead of a clip object. Your app may handle this by marking any unsuccessful responses as unavailable in your system.

Report-only Playback

If you mux (aka sync) clips into your own video files, you will not be contacting our API for fresh URLs prior to playback. Instead, your app must invoke the /music-check endpoint to pre-clear clips for playback. This endpoint takes a list of clip IDs and returns a list of IDs that are NOT playable. An empty list means all clips are licensed for playback at this time. Any IDs returned from this endpoint may be marked by your system as no longer licensed for playback.

Important Note

In both cases, once clips are cleared for playback and playback is starting, your app must invoke the /play endpoint. As a failsafe, the /play endpoint will return an error for any clips that are not licensed for playback. In this case, you should immediately stop playback to avoid licensing violations.